====== UCenter Authentication Plugin ======

---- plugin ----
description: 
author     : daxingplay 
email      : daxingplay@gmail.com 
type       : auth
lastupdate : 2016-02-17
compatible : Hrun, Detritus, Elenor of Tsort
depends    : 
conflicts  : 
similar    : 
tags       : ucenter, authentication, disucz

downloadurl: https://github.com/daxingplay/dokuwiki-plugin-authucenter/zipball/master
bugtracker : https://github.com/daxingplay/dokuwiki-plugin-authucenter/issues
sourcerepo : https://github.com/daxingplay/dokuwiki-plugin-authucenter/
donationurl: 

screenshot_img : 
----


===== Installation =====


==== Prerequisites ====

This plugin requires access to a UCenter Admin Interface. See [[#configuration_and_settings|Configuration and Settings section below]] for further information.

It has only been tested with DiscuzX 3.1 and 3.2 and 2.5, but will most likely work with any 2.x version.


==== Setup ====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.


===== Configuration and Settings =====

  - Login to Ucenter as administrator
  - Add an App in UCenter App Manager
  - Copy App settings provided by UCenter
  - Login to Dokuwiki as administrator
  - Go to your site's [[config|Configuration Manager]]
  - In the //Authentication// section
    * Set //Authentication backend// to **authucenter**
    * Add your username in UCenter to the //Superuser// list ((This will turn you into DokuWiki super users)). \\ **WARNING: failure to do so may leave you without any users having admin rights**, requiring you to manually edit the configuration file to fix the problem.
  - Scroll down to the //Authucenter// Plugin section
    * Provide the required configuration information
      * uccharset: set your Discuz charset here correctly.\\ **WARNING: incorrect setting will lead to Chinese usernames display wrongly.**
      * ucappconfig: paste your UC App config here in the textarea.
  - Save settings


===== Development =====

=== Change Log ===

See [[https://github.com/daxingplay/dokuwiki-plugin-authucenter/releases|Releases]] on Github.

=== Known Bugs and Issues ===

Please refer to the plugin's [[https://github.com/daxingplay/dokuwiki-plugin-authucenter/issues|Issue tracker on Github]]

=== ToDo/Wish List ===

Please refer to the plugin's [[https://github.com/daxingplay/dokuwiki-plugin-authucenter/issues|Issue tracker on Github]]

===== FAQ =====

==== I locked myself out, what do I do now ? ====

  * Edit your local configuration file ''./conf/local.php
  * Reset authentication to **authplain** <code>
$conf['authtype'] = 'authplain';
</code>
  * Save the file